home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / rlog.1 < prev    next >
Text File  |  1995-07-25  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. RLOG(1)                                                   RLOG(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        rlog  - print log messages and other information about RCS
  9.        files
  10.  
  11. SSYYNNOOPPSSIISS
  12.        rrlloogg [ _o_p_t_i_o_n_s ] _f_i_l_e ...
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        rrlloogg prints information about RCS files.
  16.  
  17.        Pathnames matching an RCS suffix  denote  RCS  files;  all
  18.        others   denote   working  files.   Names  are  paired  as
  19.        explained in ccii(1).
  20.  
  21.        rrlloogg prints the following information for each  RCS  file:
  22.        RCS  pathname, working pathname, head (i.e., the number of
  23.        the latest revision on the trunk), default branch,  access
  24.        list, locks, symbolic names, suffix, total number of revi-
  25.        sions, number of  revisions  selected  for  printing,  and
  26.        descriptive  text.   This  is  followed by entries for the
  27.        selected revisions in reverse chronological order for each
  28.        branch.   For  each revision, rrlloogg prints revision number,
  29.        author, date/time, state, number  of  lines  added/deleted
  30.        (with  respect  to  the  previous revision), locker of the
  31.        revision (if any), and log message.  All  times  are  dis-
  32.        played  in  Coordinated  Universal  Time  (UTC).   Without
  33.        options, rrlloogg prints complete  information.   The  options
  34.        below restrict this output.
  35.  
  36.        --LL  Ignore RCS files that have no locks set.  This is con-
  37.            venient in combination with --hh, --ll, and --RR.
  38.  
  39.        --RR  Print only the name of the RCS file.  This  is  conve-
  40.            nient  for  translating a working pathname into an RCS
  41.            pathname.
  42.  
  43.        --hh  Print only the RCS pathname, working  pathname,  head,
  44.            default  branch,  access  list, locks, symbolic names,
  45.            and suffix.
  46.  
  47.        --tt  Print the same as --hh, plus the descriptive text.
  48.  
  49.        --bb  Print information about the revisions on  the  default
  50.            branch, normally the highest branch on the trunk.
  51.  
  52.        --dd_d_a_t_e_s
  53.            Print  information  about  revisions  with  a  checkin
  54.            date/time  in  the  ranges  given  by  the  semicolon-
  55.            separated list of _d_a_t_e_s.  A range of the form _d_1<<_d_2 or
  56.            _d_2>>_d_1  selects  the  revisions  that  were   deposited
  57.            between  _d_1  and _d_2 inclusive.  A range of the form <<_d
  58.            or _d>> selects all revisions dated  _d  or  earlier.   A
  59.            range of the form _d<< or >>_d selects all revisions dated
  60.            _d or later.  A range of the form _d selects the single,
  61.  
  62.  
  63.  
  64. GNU                         1991/08/22                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLOG(1)                                                   RLOG(1)
  71.  
  72.  
  73.            latest  revision  dated  _d  or earlier.  The date/time
  74.            strings _d, _d_1, and _d_2 are in the free format explained
  75.            in  ccoo(1).   Quoting is normally necessary, especially
  76.            for << and >>.  Note that the separator is a  semicolon.
  77.  
  78.        --ll[_l_o_c_k_e_r_s]
  79.            Print  information  about  locked  revisions only.  In
  80.            addition, if the comma-separated list _l_o_c_k_e_r_s of login
  81.            names is given, ignore all locks other than those held
  82.            by the _l_o_c_k_e_r_s.  For  example,  rrlloogg --LL --RR --llwwfftt RRCCSS//**
  83.            prints the name of RCS files locked by the user wwfftt.
  84.  
  85.        --rr[_r_e_v_i_s_i_o_n_s]
  86.            prints information about revisions given in the comma-
  87.            separated list _r_e_v_i_s_i_o_n_s of revisions and  ranges.   A
  88.            range  _r_e_v_1::_r_e_v_2  means  revisions _r_e_v_1 to _r_e_v_2 on the
  89.            same branch, ::_r_e_v means revisions from  the  beginning
  90.            of  the branch up to and including _r_e_v, and _r_e_v:: means
  91.            revisions starting with _r_e_v to the end of  the  branch
  92.            containing  _r_e_v.   An  argument that is a branch means
  93.            all revisions on that branch.   A  range  of  branches
  94.            means  all revisions on the branches in that range.  A
  95.            branch followed by a .. means the  latest  revision  in
  96.            that  branch.   A  bare --rr with no _r_e_v_i_s_i_o_n_s means the
  97.            latest revision on the default  branch,  normally  the
  98.            trunk.
  99.  
  100.        --ss_s_t_a_t_e_s
  101.            prints   information   about   revisions  whose  state
  102.            attributes match one of the states given in the comma-
  103.            separated list _s_t_a_t_e_s.
  104.  
  105.        --ww[_l_o_g_i_n_s]
  106.            prints information about revisions checked in by users
  107.            with login names appearing in the comma-separated list
  108.            _l_o_g_i_n_s.   If  _l_o_g_i_n_s  is  omitted, the user's login is
  109.            assumed.
  110.  
  111.        --VV_n Emulate RCS version _n when generating logs.  See ccoo(1)
  112.            for more.
  113.  
  114.        --xx_s_u_f_f_i_x_e_s
  115.            Use _s_u_f_f_i_x_e_s to characterize RCS files.  See ccii(1) for
  116.            details.
  117.  
  118.        rrlloogg prints the intersection  of  the  revisions  selected
  119.        with  the options --dd, --ll, --ss, and --ww, intersected with the
  120.        union of the revisions selected by --bb and --rr.
  121.  
  122. EEXXAAMMPPLLEESS
  123.            rrlloogg  --LL  --RR  RRCCSS//**
  124.            rrlloogg  --LL  --hh  RRCCSS//**
  125.            rrlloogg  --LL  --ll  RRCCSS//**
  126.            rrlloogg  RRCCSS//**
  127.  
  128.  
  129.  
  130. GNU                         1991/08/22                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RLOG(1)                                                   RLOG(1)
  137.  
  138.  
  139.        The first command prints the names of all RCS files in the
  140.        subdirectory  RRCCSS  that  have  locks.   The second command
  141.        prints the headers of those files, and  the  third  prints
  142.        the headers plus the log messages of the locked revisions.
  143.        The last command prints complete information.
  144.  
  145. EENNVVIIRROONNMMEENNTT
  146.        RRCCSSIINNIITT
  147.               options prepended to the argument  list,  separated
  148.               by spaces.  See ccii(1) for details.
  149.  
  150. DDIIAAGGNNOOSSTTIICCSS
  151.        The exit status is zero if and only if all operations were
  152.        successful.
  153.  
  154. IIDDEENNTTIIFFIICCAATTIIOONN
  155.        Author: Walter F. Tichy.
  156.        Revision Number: 5.3; Release Date: 1991/08/22.
  157.        Copyright (C) 1982, 1988, 1989 by Walter F. Tichy.
  158.        Copyright (C) 1990, 1991 by Paul Eggert.
  159.  
  160. SSEEEE AALLSSOO
  161.        ci(1), co(1), ident(1), rcs(1),  rcsdiff(1),  rcsintro(1),
  162.        rcsmerge(1), rcsfile(5)
  163.        Walter  F.  Tichy,  RCS--A  System  for  Version  Control,
  164.        _S_o_f_t_w_a_r_e_-_-_P_r_a_c_t_i_c_e  _&  _E_x_p_e_r_i_e_n_c_e  1155,  7   (July   1985),
  165.        637-654.
  166.  
  167. BBUUGGSS
  168.        The separator for revision ranges in the --rr option used to
  169.        be -- instead of ::, but this leads to confusion  when  sym-
  170.        bolic  names  contain --.  For backwards compatibility rrlloogg
  171.        --rr still supports the old -- separator, but it warns  about
  172.        this obsolete use.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. GNU                         1991/08/22                          3
  197.  
  198.  
  199.